Skip to content

Add basic troubleshooting guide#5142

Merged
gefjon merged 4 commits into
masterfrom
phoebe/docs/basic-troubleshooting-guide
Jun 1, 2026
Merged

Add basic troubleshooting guide#5142
gefjon merged 4 commits into
masterfrom
phoebe/docs/basic-troubleshooting-guide

Conversation

@gefjon

@gefjon gefjon commented May 28, 2026

Copy link
Copy Markdown
Contributor

Description of Changes

Adds a basic troubleshooting guide for some common issues we've seen users encounter.

API and ABI breaking changes

N/a: it's docs.

Expected complexity level and risk

1: it's docs.

Testing

N/a.

@JulienLavocat JulienLavocat left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, one minor comment

Comment thread docs/docs/00300-resources/00050-troubleshooting.md Outdated

@JasonAtClockwork JasonAtClockwork left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation looks solid but it looks like due to the location of the doc it doesn't show up for the sidebar. The root folders, like /docs/00300-resources, doesn't have auto-generated entries so either we need to add a manual entry for 00300-resources or move the doc into a folder with auto-generated.

@gefjon gefjon requested a review from JasonAtClockwork June 1, 2026 18:12
@gefjon

gefjon commented Jun 1, 2026

Copy link
Copy Markdown
Contributor Author

@JasonAtClockwork I moved the new page inside 00300-resources, and added a ref to it in the sidebar root for more visibility.

@JasonAtClockwork JasonAtClockwork left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, the new easy to access menu option is nice to have.

@gefjon gefjon enabled auto-merge June 1, 2026 18:36
@gefjon gefjon added this pull request to the merge queue Jun 1, 2026
Merged via the queue into master with commit c70d002 Jun 1, 2026
32 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants